home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / mutt100.zip / MUTT.DOC < prev    next >
Text File  |  1991-11-23  |  8KB  |  397 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                                     M.U.T.T.
  25.                             Maximus User's Time Tank
  26.                                  Version 1.00
  27.  
  28.  
  29.  
  30.                         Copyright 1991 by Peter G. Zion.
  31.                               All rights reserved.
  32.  
  33.                              Docs by Carl Slawinski
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                                   WHAT IS IT?
  74.                                   -----------
  75.  
  76.               It's yet another Time Bank!!! We're assuming (dangerous
  77.          as that may be) that if you are a Maximus sysop that you are
  78.          an intelligent enough life form to understand this without
  79.          further explanation. After all, you were smart enough to pick
  80.          the greatest BBS software around! Of course, MUTT is written
  81.          exclusively for Maximus! (Version 2.00 as of this writing)
  82.  
  83.  
  84.  
  85.                           HOW AND WHERE CAN I GET IT?
  86.                           ---------------------------
  87.  
  88.          If you are reading this documentation <yuk>, you already have
  89.          it. Geez, you ask some dumb questions!
  90.  
  91.  
  92.                                    OH YEA??
  93.                                    ---------
  94.  
  95.               Yea!
  96.  
  97.  
  98.  
  99.                                     FEATURES
  100.                                     --------
  101.  
  102.          * It works!!
  103.  
  104.          * Sysop may control the amount of time a user may have in the
  105.            tank.
  106.  
  107.          * Sysop may control amount of time that may be deposited and
  108.            withdrawn in one day
  109.  
  110.          * User may send witty 1 line messages to other users of MUTT
  111.  
  112.          * Users may attempt to Steal Time from other users
  113.  
  114.          * Sysop controls % of time that a thief gets as well as the
  115.            % of time the user loses if he is unsuccessful
  116.  
  117.          * Sysop has the option of hanging up on users that fail
  118.            their attempt to steal time from another user
  119.  
  120.          * Status Bar
  121.  
  122.          * Chat Function
  123.  
  124.          * Sysop can boot user off system with ALT-X!
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.                                QUICK INSTALLATION
  140.                                ------------------
  141.          (yes, I know what I'm doing just give me the down and dirty)
  142.  
  143.  
  144.               MUTT is very easy to install! (really!) Because of the
  145.          necessity to exit Maximus to update the time, MUTT uses the
  146.          External Errorlevel type execution method.
  147.  
  148.  
  149.          First, copy all the MUTT files to your main Maximus directory.
  150.          Then, in MENUS.CTL simply add a line to the desired menu which
  151.          reads something similar to:
  152.  
  153.  
  154.          Xtern_Erlvl 99_Mutt_%P_%b_%k         Normal "Time Tank"
  155.  
  156.  
  157.          MUTT needs the Port, Baud Rate, and Node. Thus the
  158.          translations.
  159.  
  160.  
  161.          In your batch file that runs Maximus simply add the
  162.          errorlevel after Maximus exits and a label similar to the
  163.          following:
  164.  
  165.          cd \max
  166.          max (with your parameters here)
  167.          :After_Max
  168.          If ERRORLEVEL 255 goto Do Something
  169.          If ERRORLEVEL  99 goto Mutt
  170.          If ERRORLEVEL   4 goto Do This
  171.          If ERRORLEVEL   3 goto Do That
  172.          If ERRORLEVEL   2 goto Do Something_Else
  173.          If ERRORLEVEL   1 goto Do Whatever
  174.  
  175.          :Mutt
  176.          cd \max
  177.          Call Errorlvl.Bat (For Multinode setups Call ErrorlXX.Bat)
  178.          max -r (your parameters)
  179.          Goto After_Max
  180.  
  181.  
  182.  
  183.          In your Nightly Maintenance batch file, add a line to run the
  184.          maintenance MUTT needs to do every night. Example:
  185.  
  186.          MUTT MAINT
  187.  
  188.  
  189.          The Final step involves using your favourite text editor to
  190.          EDIT MUTT.CFG to suit your needs. It's documented and
  191.          self explanatory, so we won't go into it here.
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.          Again, the quick run down is:
  207.  
  208.          (1) Edit your MENUS.CTL
  209.          (2) Edit your BBS Batch File
  210.          (3) Put the MUTT MAINT in your Nightly Event
  211.          (4) Edit MUTT.CFG
  212.  
  213.  
  214.          That's It!!!!
  215.  
  216.  
  217.  
  218.                            NOT SO QUICK INSTALLATION
  219.                            -------------------------
  220.  
  221.              Read the section entitled QUICK INSTALLATION 5 times!!
  222.  
  223.  
  224.                             REALLY SLOW INSTALLATION
  225.                             ------------------------
  226.  
  227.             Read the section entitled QUICK INSTALLATION 10 TIMES!!
  228.  
  229.  
  230.  
  231.               BOY, THIS DOCUMENTATION IS TERRIBLE. WHO WROTE THIS?
  232.               ----------------------------------------------------
  233.  
  234.           Listen! We've had just about enough of you for an eternity!
  235.          Quit complaining and keep reading!
  236.  
  237.  
  238.  
  239.                               FUTURE ENHANCEMENTS
  240.                               -------------------
  241.  
  242.          Actually, MUTT is being released somewhat earlier than
  243.          originally intended (all the features are not present) due to
  244.          the fact for a real need for a Time Tank. Some of the
  245.          additional features already being worked on are:
  246.  
  247.          Note: No Guarantees! 8-) Sorry!
  248.  
  249.          * Byte Tank - Users can store unused Download Bytes
  250.  
  251.          * Gamble for Time! A casino for users to have at it!
  252.  
  253.          * Sysop Menu to allow the sysop to manually manipulate time
  254.            and such in the user file
  255.  
  256.          * Time Shark! <tm> User can visit Time Sharky to borrow time
  257.            that must be paid back with interest!
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.                                IT'S CANADIAN EH?
  273.                                -----------------
  274.  
  275.          MUTT is another fine Canadian product, although most of the
  276.          original ideas and most of the Neat stuff were thought up by
  277.          Americans of course!  8-)  [at least I remembered to correct
  278.          the incorrect American spellings such as "flavor" -Peter :-)]
  279.  
  280.  
  281.                                     LICENCE
  282.                                     -------
  283.  
  284.          Use of MUTT is at your own risk. The author takes no
  285.          responsibility for anything that results from the use of
  286.          MUTT. No fee may be charged for MUTT except as part of a file
  287.          library on a BBS which charges users for download access.
  288.          Peter G. Zion retains all ownership of MUTT.
  289.  
  290.  
  291.                               SPECIAL THANKS LIST
  292.                               -------------------
  293.  
  294.                            Scott Dudley for Maximus!
  295.                  All 567 beta testers! (too many to list here)
  296.             [And especially Carl Slawinski for writing the docs! -Peter]
  297.  
  298.  
  299.                              SPECIAL NO THANKS LIST
  300.                              ----------------------
  301.  
  302.                  You know who you are! We know where you Live!!
  303.  
  304.  
  305.                              CONTACTING THE AUTHOR
  306.                              ---------------------
  307.  
  308.          If you are having problems or have questions regarding MUTT,
  309.          the author may be reached by the following methods:
  310.  
  311.          BBS:
  312.  
  313.             Pete's Bar and Grill - Kingston, Ontario (613) 531-9801
  314.  
  315.                                Fidonet: 1:249/148
  316.  
  317.          MAIL: (for all the postcards, cash and computer gear!) 8-)
  318.  
  319.                                43 Newcourt Place
  320.                                Kingston, Ontario,
  321.                                  K7M 6Y1 CANADA
  322.  
  323.          Also, the author frequents the International Fidonet Echo
  324.          MUFFIN, International Fidonet Echo TUB, as well as several
  325.          seedy singles bars that we'd rather not mention here!
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.